home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / mpeg_play-2.1 / INSTALL < prev    next >
Text File  |  1995-05-09  |  4KB  |  106 lines
  1. These are the instructions for compiling mpeg_play, the software MPEG
  2. decoder and player.
  3.  
  4. 1) Untar the file mpeg_play.tar.gz. This is best done by creating a new
  5. directory for the files involved, moving the tar file into this directory
  6. and invoking the command:
  7.  
  8.     zcat mpeg_play-2.1.tar.gz | tar xvf -
  9.     (or gtar -zxvf mpeg_play-2.1.tar.gz )
  10.  
  11. 2) Create and customize the Makefile. Do this by copying the file
  12. Makefile.proto to Makefile. Then edit Makefile for your particular needs.
  13.  
  14. In the Makefile the CFLAGS definition is multiply defined for a couple of
  15. different machines, uncomment the one you want to use, or define your own
  16. if necessary. 
  17.  
  18. The INCLUDEDIR variable should be set to include the paths leading to the
  19. standard header files such as stdio.h as well as to X11/Xlib.h  (on most
  20. systems, this is /usr/include).  To do this set the INCLUDEDIR variable to
  21. -I followed by the pathname. For example, if the path is /usr/local/include,
  22. edit the Makefile to look like this:
  23.  
  24.     INCLUDEDIR       = -I/usr/local/include
  25.  
  26. If more than one pathname is necessary, simply prepend -I to each path.
  27. For example if you needed to include /usr/local/include and /usr/X11/include,
  28. the variable definition would look like:
  29.  
  30.     INCLUDEDIR       = -I/usr/local/include -I/usr/X11/include
  31.  
  32. Finally, make sure the LIBS variable is set to the path and name of your 
  33. Xext and X11 librarys. For example:
  34.  
  35.     LIBS             = /usr/lib/X11/libXext.a /usr/lib/X11/libX11.a
  36.  
  37. or 
  38.     LIBS = -lXext -lX11
  39.  
  40. 3) Type make all.
  41.  
  42. 4) To remove .o files, type make clean
  43.  
  44. 5) Install mpeg_play and mpeg_play.1 into the appropriate places.
  45.  
  46. 6) Try it out! You can ftp some sample data files from the same site
  47.    you got this player from. Data files usually end in .mpg or .mpeg
  48.    The command line for the player is described in the man page, but
  49.    is basically:
  50.  
  51.    mpeg_play [options] [file_name] 
  52.  
  53. 7) If you want the player to collect statistics on size of frames, 
  54.    macroblocks, time to decode, etc., add the following to the 
  55.    definition of CFLAGS in the Makefile:
  56.     -DANALYSIS
  57.    Remove all .o files with "make clean" and remake with "make all"
  58.    The player will now print summarized statistics at the end of the
  59.    video clip and can be made to print frame by frame statistics with
  60.    the use of the -eachstat flag. Read man page for more info.
  61.  
  62.    You may prefer to use mpeg_stat if you're really into statistics.
  63.  
  64. ------------------------------------------------------------------------
  65.  
  66. Using Imake
  67.  
  68. We have included an Imakefile for use with Imake. Since we do not use
  69. Imake ourselves and the file was provided by someone else, we can not
  70. give any specific instructions on how to use it. Please, consult
  71. someone more experienced with Imake. 
  72. Thanks.
  73.  
  74. ------------------------------------------------------------------------
  75.  
  76. NOTES
  77.  
  78. It seems that much of the time is spent converting the 24 bit MPEG image
  79. to an 8 bit color space. This process is called "dithering".  We've included
  80. several dithering algorithms.  Read the man pages for more instructions.
  81.  
  82. The data files available are produced by XING. These images are
  83. usually small (~160X120). XING data does not take advantage
  84. of P or B frames (ie, frames with motion compensation). The data is simply
  85. a series of I frames.  Performance of the player on XING data is
  86. significantly lower (half or less) of the performance when motion compensated
  87. MPEG data is decoded. 
  88.  
  89. Reporting bugs:
  90.     If you find any bugs in this software, please send them to
  91.     mpeg-bugs@plateau.cs.berkeley.edu.  Since this software
  92.     is unsupported, we make no guarantees about how long it will
  93.     take to fix the bug, or if it will be fixed at all.  Bug fixes
  94.     will be cheerfully accepted.  Please include as much detailed
  95.     information as possible, including:
  96.  
  97.     1) the version number of the program you are using (cf. VERSION)
  98.     2) the data file that caused the bug (if possible)
  99.     3) the OS version and machine type you ran the program on
  100.     4) the compiler used to compile the program
  101.  
  102.  
  103.  
  104.  
  105.  
  106.